home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d13 / pcshl1.arc / PCSHELL.DOC < prev    next >
Encoding:
Text File  |  1991-10-07  |  10.6 KB  |  276 lines
  1.         
  2.         
  3.                                   POWER C SHELL
  4.                                    VERSION 1.0
  5.                                    
  6.                        Copyright 1991 by Chuck Steenburgh
  7.                        
  8.         DISTRIBUTION LIMITATIONS:  This is a copyrighted shareware
  9.         program.  You have a limited license to try out this soft-
  10.         ware on a single computer for a period of 30 days.  If you
  11.         continue to use the software after this 30-day trial period,
  12.         you must become a registered user.
  13.         
  14.         REGISTRATION:  There are two ways to register this program.
  15.         The easiest is to become a member of the unofficial Power C
  16.         Users Group on CompuServe.  Send E-mail to the author to
  17.         join; membership is completely free and the organization is
  18.         very informal.  Either form of registration will enable you
  19.         to receive a copy of the Power C source code for the program.
  20.         
  21.             Alternately, you may register by sending a voluntary
  22.         contribution of $10 to the address shown at the bottom of
  23.         this documentation.
  24.         
  25.         DISCLAIMER:  The author warrants this program to do abso-
  26.         lutely NOTHING.  It does, however, in my experience, per-
  27.         form as described in this documentation.  The author accepts
  28.         no liability for any damage this program may cause to your
  29.         PC (although I really can't envision this happening).  USE
  30.         OF THIS PROGRAM IS AT YOUR OWN RISK.
  31.         
  32.         Now that the semi-legal mumbo-jumbo is out of the way,
  33.         welcom to POWER C SHELL Version 1.00.  This program
  34.         was written as a simple aid to Power C programmers.
  35.         POWER C SHELL Version 1.00 has the following features:
  36.         
  37.             - Simplify editing, compiling, and debugging
  38.             of POWER C programs without having to fool with
  39.             the DOS command line;
  40.             
  41.             - Customizable editor and viewer
  42.             
  43.             - Customizable compile options for Power C compiler
  44.             
  45.             - Ability to review C.ERR error listing without
  46.             leaving the shell
  47.             
  48.             - Test run your executable programs without
  49.             leaving the shell
  50.             
  51.         
  52.         
  53.         STARTING POWER C SHELL VERSION 1.00
  54.         
  55.             Power C Shell itself requires a mere 26K of free memory
  56.         to run, although 81K is preferred.  To this amount, however,
  57.         you must add the greater of the memory required by your editor,
  58.         viewer, and whatever C program you happen to be working on.
  59.         Power C Shell remains in memory when these programs are exec-
  60.         uting.
  61.         
  62.             Environment Variables
  63.             =====================
  64.             
  65.             Power C Shell configures itself through the use of
  66.         environment variables.  These are much fatser and "cleaner"
  67.         than the use of a configuration file.  Power C Shell under-
  68.         stands the following environment variables:
  69.         
  70.             PCEDIT: complete path of your editor
  71.             PCEDITP: any command line parameters used by your editor
  72.             PCVIEW: complete path of your viewer
  73.             PCVIEWP: any command line parameters used by your viewer
  74.             COMPILE: default compile options to be used by PC.EXE
  75.             
  76.             Environment variables are established by use of the DOS
  77.         SET command.  To set the name of your viewer to C:\LIST.COM,
  78.         simply type the following at the DOS command line:
  79.         
  80.             SET PCVIEW=C:\LIST.COM
  81.             
  82.             Use a similar procedure to set the other variables.  To
  83.         set your default compile options to "/e/ms" (link file, use
  84.         small memory model), type the following on the DOS command line:
  85.         
  86.             SET COMPILE=/e/ms
  87.             
  88.             If, while entering your environment variables, you get
  89.         the message "Out of environment space" or something similar,
  90.         you need to edit your AUTOEXEC.BAT file.  Look for a state-
  91.         ment similar to the following:
  92.         
  93.             SET COMSPEC=c:\dos\command.com
  94.             
  95.             To increase the environment space, change the statement
  96.         to something like this:
  97.         
  98.             SET COMSPEC=c:\dos\command.com /e:384
  99.             
  100.             In the example above, 384 is the new number of bytes
  101.         reserved for the environment (160 is the default).  DOS
  102.         will always round this number to a multiple of 16.  384
  103.         bytes should be enough for most users, although you may
  104.         need more.  The limit is 32,768, although there should
  105.         never be a need for more than 1 or 2K.   See your DOS man-
  106.         ual for more details on setting the environment size.  
  107.         Note that you must reboot your computer after editing your
  108.         AUTOEXEC.BAT file for any changes to take effect.
  109.         
  110.         
  111.             In order to use the editing and viewing options of
  112.         Power C Shell, you MUST specify the PCEDIT and PCVIEW
  113.         environment variables.  Compile options can be changed 
  114.         from inside the program itself.
  115.         
  116.             The PCEDITP and PCVIEWP parameter variables assume
  117.         that your editor and viewer accept command line switches
  118.         AFTER the filename to edit/view.  For example:
  119.         
  120.             <PCEDIT> (filename) <PCEDITP>
  121.               edit   program.c   -x -e
  122.               
  123.             If your editor/viewer only accept parameters and
  124.         switches BEFORE the filename, enter them as part of
  125.         the PCEDIT or PCVIEW varaibles.  For example:
  126.         
  127.             <PCEDIT>     (filename)
  128.             edit -x -e   program.c
  129.             
  130.             you would enter the following command on the DOS
  131.         command line prior to starting Power C Shell:
  132.         
  133.             SET PCEDIT=edit.exe -x -e
  134.             
  135.             
  136.             Running Power C Shell
  137.             =====================
  138.             
  139.             To run Power C Shell, simply type PCSHELL at the 
  140.         DOS command line.  (NOTE:  you must either be in the
  141.         same directory as PCSHELL.EXE, or you must have that
  142.         directory specified in your PATH statement.)
  143.         
  144.         
  145.             A Word About Directories
  146.             ========================
  147.             
  148.             The optimum configuration for Power C Shell is
  149.         to have the PCSHELL.EXE program, all of your POWER C
  150.         programs and files, and your C source files in the
  151.         same directory.  PCSHELL will automatically search
  152.         for your viewer and editor on the DOS path if you
  153.         do not specify a complete path in the environment
  154.         variables.
  155.         
  156.         
  157.         POWER C SHELL MENU OPTIONS
  158.         
  159.         
  160.             [1] Edit C Source File
  161.             
  162.             Selecting "1" and pressing enter will invoke your
  163.         editor to edit the file specified as your working file.
  164.         The extension ".c" is automatically appended.  See the
  165.         explanation for menu item [5] below.  Upon exiting your
  166.         editor, you will be returned to the Power C Shell main
  167.         menu.
  168.         
  169.         
  170.         
  171.             [2] Compile C Source File
  172.             
  173.             Selecting "2" and pressing enter will invoke
  174.         the PC.EXE compiler with any command line parameters
  175.         you may have specified.  See the explanation for
  176.         menu items [3] and [5] below.  The extension ".c"
  177.         is automatically appended to the name of your working
  178.         file which is then compiled.
  179.         
  180.             In order to produce an executable file (.exe),
  181.         make sure you specify "/e" as one of your compile 
  182.         options.
  183.         
  184.             In order to produce an up-to-date C.ERR file,
  185.         make sure you specify "/c" as one of your compile
  186.         options.
  187.         
  188.         
  189.             [3] Set Compile Options
  190.             
  191.             Select this option to enter the compile options
  192.         for the Power C compiler.  You will see the following
  193.         line near the bottom of the screen:
  194.         
  195.                 Enter compile options: 
  196.                 
  197.             Simply type the compile options exactly as they
  198.         would be entered on the command line.  For example,
  199.         to force use of 8087/80287 floating point library and
  200.         use the large memory model, enter "/f8/ml" and then
  201.         press enter.
  202.         
  203.         
  204.             [4] View C.ERR File
  205.             
  206.             Select this option to view the compile error
  207.         listing.  Your viewer will be invoked for the 
  208.         C.ERR file.
  209.         
  210.         
  211.             [5] Set Working File
  212.             
  213.             Selecting this option allows you to specify
  214.         the name of your source file.  Enter the filename
  215.         WITHOUT any extensions (these will automatically
  216.         be appended as needed by the program).
  217.         
  218.         
  219.             [6] Test Execute File
  220.             
  221.             This option will execute your program.  To
  222.         work correctly, you must have properly compiled 
  223.         the source file currently named as your working
  224.         file.  Upon properly exiting the program, you
  225.         will be returned to the Power C Shell.  There
  226.         must be enough free memory available for both
  227.         Power C Shell (26-81k) and your program.
  228.         
  229.         
  230.             You will first be prompted for any command
  231.         line parameters your program will need.  Type the
  232.         parameters exactly as they would appear on the 
  233.         command line, then press enter.  If your program
  234.         uses no arguments, simply press enter.
  235.         
  236.         
  237.             [7] Exit to DOS
  238.             
  239.             Select this option to leave Power C Shell
  240.         and return to DOS.
  241.         
  242.         
  243.         
  244.         SYSTEM LIMITATIONS
  245.         
  246.             Some of the environment variables and other inputs
  247.         to the program have strict size limitations as follows:
  248.         
  249.             Working file name:  8 characters, NO EXTENSION
  250.             PCEDIT variable:  39 characters
  251.             PCEDITP variable: 11 characters
  252.             PCVIEW variable:  39 characters
  253.             PCVIEWP variable: 11 characters
  254.             COMPILE variable: 11 characters
  255.             Compile options:  11 characters
  256.             Command line arguments for test execution:  39 characters
  257.         
  258.         
  259.         MISCELLANEOUS
  260.         
  261.             Direct questions, comments, or registrations to the
  262.         program author:
  263.         
  264.                     Chuck Steenburgh
  265.                     304A North Main Street
  266.                     Lexington, VA 24450
  267.                     
  268.                     (703)464-5290 evenings
  269.                     CIS ID: 72330,1776
  270.                     
  271.             Power C Users Group
  272.             IBM Programming Forum (GO IBMPRO)
  273.             C Message Section
  274.            
  275.        
  276.